home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / os20 / wb / cpuctrl.readme < prev    next >
Text File  |  1992-08-09  |  9KB  |  184 lines
  1. Short: OS2.x CPU-like program including GUI
  2.  
  3. --------------------------------------------------------------------------
  4.                         CPU-Control 1.3a (7-Jul-92)
  5. --------------------------------------------------------------------------
  6.  
  7. CPU-Control  is  a  CPU-like utility for Kickstart/WB 2.0 including a GUI.
  8. The  main  difference  to  other  tools  of this kind is, that CPU-Control
  9. recognizes  external  changes  of  any of its parameters.  Because of this
  10. special  feature it needs some CPU-Time (not much), but in iconified state
  11. it needs no processor time at all.  Additionally CPU-Control allows moving
  12. VBR  (VectorBaseRegister)  to  Fast-RAM, which significantly speeds up all
  13. Traps/Interupts.   Many  CLI  Options have been included to allow usage in
  14. scripts,  so it's a good idea to put "CPU-Control vbr nw" in your Startup-
  15. Sequence.
  16.  
  17. --------------------------------------------------------------------------
  18.                                Requirements
  19. --------------------------------------------------------------------------
  20.  
  21. Amiga-OS 2.04 or higher is required to run CPU-Control.
  22.  
  23. --------------------------------------------------------------------------
  24.                                 CLI Usage
  25. --------------------------------------------------------------------------
  26.  
  27. Parameter      Shortform     Effect                             CPU needed
  28. --------------------------------------------------------------------------
  29. (none)                       just starts CPU-Control
  30. ICACHE            I          enable  Instruction Cache            68020+
  31. NOICACHE          NI         disable Instruction Cache            68020+
  32. DCACHE            D          enable  Data Cache                   68030+
  33. NODCACHE          ND         disable Data Cache                   68030+
  34. IBURST            IB         enable  Instruction Burst            68030
  35. NOIBURST          NIB        disable Instruction Burst            68030
  36. DBURST            DB         enable  Data Burst                   68030
  37. NODBURST          NDB        disable Data Burst                   68030
  38. VBR                          move VBR to FastRAM                  68010+
  39. NOVBR                        normal VBR (Zero)                    68010+
  40. COPYBACK          CB         enable  Copyback                     68040
  41. NOCOPYBACK        NCB        disable Copyback                     68040
  42. MMU                          enable  FastROM/SafeKick        | 68020/851 |
  43. NOMMU                        disable FastROM/SafeKick        |  or 68030 |
  44. MOVESSP           SSP        move SSP to FastRAM
  45. VERBOSE           V          Verbose output
  46. CHECK                        check for a specified processor
  47.                              (68010/68020/68030/68040/68881/68882/FPU/MMU)
  48. ICONIFY           IC         starts iconified
  49. NOWIN             NW         starts without GUI
  50. CCI                          Chip-Cache-Inhibit (see update notes)
  51.  
  52. Example: CPU-Control I D IB NDB VBR SSP MMU V NW
  53.  
  54.          enables all Caches,  enables IBurst,  disables DBurst,  moves VBR
  55.          and SSP  to FastMem,  enables the MMU  (FastROM or SafeKick)  and 
  56.          prints the new status verbosely without opening the GUI.
  57.  
  58. --------------------------------------------------------------------------
  59.                               Technical Info
  60. --------------------------------------------------------------------------
  61.  
  62. CPU-Control  has been developed using HiSoft's wonderful DevPac 3.02.  The
  63. GUI  was  designed using  GadToolsBox 1.3, but the code was so bad, that I
  64. decided to rewrite it.
  65.  
  66. All  cache  manipulations are done using Exec's CacheControl, VBR movement
  67. is  done  by  allocating  1024 Bytes of memory using AllocMem, copying the
  68. area,  and then setting the VBR register to the new value.  Enforcer would
  69. complain  about  this,  but you can simply ignore it.  Just for safety the
  70. routine  in  embedded  in Forbid/Permit, and Caches are cleared via Exec's
  71. CacheClearU.
  72.  
  73. The  MMU  option automagically selects FastROM-mode for ROM-Kickstarts and
  74. SafeKick-mode  for Kickstarts  loaded by ZKick/LKick ($200000).  It is NOT
  75. compatible to the WB-2.0 "CPU" command, because the MMU-Table used is much
  76. more  efficient, and in addition to "CPU" it write-protects the RAM-image.
  77. Alien-MMU-Activations  make the "Safe/Fast OS" gadget unavailable, and the
  78. Verbose  CLI mode  will show up "(MMU)", which means the MMU is active but
  79. incompatible to CPU-Control.  And again:  Ignore Enforcer!
  80. _LVOColdReboot  will  be  patched on MMU-activation in order to switch off
  81. the  MMU  before resetting.  A BusError-Handler makes the RAM-image behave
  82. like a real ROM.
  83.  
  84. 68020's without MMU (68851) and 68EC030 (68030-Light) should be recognized
  85. correctly.
  86.  
  87. While the full GUI is open, CPU-Control uses a Delay/GT_GetIMsg loop to be
  88. able to recognize changes of the Cache/VBR. In iconified (zoomed) state it
  89. uses Exec's Wait without using any processor time.
  90.  
  91. The MOVESSP option should only be used in Startup-Sequences, because it is
  92. a  quite  dangerous  operation.   SSP will only be moved, if there is REAL
  93. FastRAM  available and SSP is currently in SlowRAM.  This operation is not
  94. reversible.
  95.  
  96. --------------------------------------------------------------------------
  97.                                Future Plans
  98. --------------------------------------------------------------------------
  99.  
  100. - FastROM and SafeKick options with 68040 support
  101.   Beta-Testers with 68040 wanted!
  102.  
  103. - Tooltypes
  104.  
  105. - Cache-Inhibit for Commodore's PC/AT-Bridgeboards
  106.  
  107. - (any more ideas?)
  108.  
  109. --------------------------------------------------------------------------
  110.                                  History
  111. --------------------------------------------------------------------------
  112.  
  113. 1.0     -       initial release:  8-May-92
  114.  
  115. 1.1     -       release date:    13-May-92
  116.  
  117.                 - many serious bugs (hopefully) fixed
  118.                 - overall code optimisation
  119.                 - added 68020/851 and 68030 MMU support
  120.                 - added "ICONIFY" option
  121.  
  122. 1.2     -       release date:    14-May-92
  123.  
  124.                 - added CHECK option to test for a specified processor
  125.                   Example: CPU-Control check 68030
  126.                            will produce an ErrorCode 5 if not found
  127.                   CHECK always activates the NOWIN option
  128.                 - cleaned-up menu layout
  129.  
  130. 1.3     -       release date:    16-May-92
  131.  
  132.                 - added MOVESSP option to allow moving the Supervisor
  133.                   Stackpointer to fast memory
  134.                 - CLI mode (especially CHECK) can now be used on 68000
  135.                 - minor code cleanup
  136.  
  137. 1.3a    -       release date:     7-Jul-92
  138.  
  139.                 - Cache-Inhibit for ChipRAM is no longer set automatically
  140.                   because every well-behaving hardware (including A3000
  141.                   and A2620/30 Turboboards) does this already.
  142.                   In addition operation in ChipRAM is slightly faster now,
  143.                   because the hardwired solution effects Datacache only.
  144.                   In case of trouble the CCI option (CLI only!) could be
  145.                   used to enable Cache-Inhibit. Of course this option is
  146.                   only useful if used together with the MMU option.
  147.  
  148.  
  149.                 ATTENTION: If the main progamm file doesn't have a length
  150.                            of 5644 Bytes it is DAMAGED!
  151.  
  152. --------------------------------------------------------------------------
  153.                                 Shareware
  154. --------------------------------------------------------------------------
  155.  
  156.                         CPU-Control is SHAREWARE!
  157.  
  158.         If you use this program for a longer period than one week,
  159.             please send me a donation of 10 US$ or equivalent!
  160.  
  161.                       So if you want more tools like
  162.                CPU-Control, TagScreens, UnArp and Safekick
  163.               think about it and keep developers developing.
  164.  
  165.                                 THANK YOU!
  166.  
  167.  
  168.                       Registered-User-Counter: 00001
  169.  
  170. --------------------------------------------------------------------------
  171.                                   Author
  172. --------------------------------------------------------------------------
  173.  
  174.                  Send bug-reports and/or suggestions to:
  175.  
  176.                               Martin Berndt
  177.                            Fr.-Alfred-Str. 115
  178.                              4100 Duisburg 14
  179.                                  Germany
  180.  
  181. --------------------------------------------------------------------------
  182.  
  183. (End of this wonderful document)
  184.